home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / bbs / compr214.zip / COMPARE.DOC next >
Text File  |  1991-04-21  |  9KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         _________________________________________________________________
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                                   COMPARE
  32.                       BBS File List Comparing Utility
  33.  
  34.                                User's Manual
  35.  
  36.                                 Version 2.14
  37.                       Copyright (c) 1991 Edward Gause
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.      _________________________________________________________________
  63.                      Thank you for supporting Shareware
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.      ABOUT COMPARE
  74.  
  75.      Compare is a handy utility  for  comparing  file  lists  obtained from
  76.      Bulletin Board Systems (BBS).  Optionally, you may also build your
  77.      own list of files that you already have. How many times have you
  78.      tried uploading a file to a particular BBS and received the
  79.      "File already exist" notice?  By using COMPARE, you can determine
  80.      what files a BBS has (or possibly one or two you  may  not  have!) and
  81.      save  some  on-line  time  and  frustration.   Hence,  my  reason  for
  82.      developing this program in the first place!
  83.  
  84.  
  85.      SYSTEM REQUIREMENTS
  86.  
  87.      The following configuration is the minimum required to run COMPARE:
  88.  
  89.          IBM PC/XT/AT or Compatible with 256k
  90.          2 Disk Drives (5.25 and/or 3.50)
  91.          Monochrome, CGA, EGA or VGA Monitor
  92.          PC/MS-DOS 2.0 or higher
  93.  
  94.      A hard  drive is highly encouraged  if  comparing  very  large  files.
  95.      Several temporary files are created during operation and if disk
  96.      space is limited runtime errors may occur.  Also,  a  hard  drive will
  97.      speed up read/write process during the file comparisons.
  98.  
  99.  
  100.      USING COMPARE
  101.  
  102.      Floppy Disk Users:
  103.  
  104.        1.  Place the diskette containing COMPARE.EXE in drive A.
  105.  
  106.        2.  Place a blank, formatted diskette in drive B.
  107.  
  108.        3.  At the "A:" prompt, type "COMPARE" (without quotes).
  109.  
  110.        4.  Shareware users will get a copyright notice screen displayed
  111.            for  10  seconds.   Afterwards, press any key to continue to the
  112.            Main Menu.
  113.  
  114.  
  115.      Hard Disk Users
  116.  
  117.        1.  Make a sub-directory called "COMPARE" or whatever name you
  118.            choose.
  119.  
  120.        2.  Copy the program COMPARE.EXE to the newly created sub-
  121.            directory and change to that directory.
  122.  
  123.        3.  Type "COMPARE" (without quotes).
  124.  
  125.  
  126.  
  127.  
  128.        ___________________________________________________________________
  129.        COMPARE Version 2.14                                          Page 1
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.        MAIN MENU
  140.  
  141.        The Main Menu is the heart of the program.  From  here you may build
  142.        your  own  file  lists,   compare file lists that you've downloaded,
  143.        sort output lists or quit the program.
  144.  
  145.        Build File Lists
  146.  
  147.        Selecting this option prompts  you  for  a filename to build and the
  148.        path  where  the files are stored.  You must follow  DOS  convention
  149.        here  when  naming  files.  That is, filenames must not exceed eight
  150.        characters in length followed  by  a  period and a file extension of
  151.        three characters (or less).
  152.  
  153.        The  default  working  path  for  hard drive users  is  the  current
  154.        directory.  Floppy disk users will enter "B:" here.  Hard disk users
  155.        will enter the path where  they  keep  their  downloaded  files.  If
  156.        reading from floppy diskettes, you will have to repeat  this process
  157.        for  each diskette.  Hard Drive users should copy all their files to
  158.        one specific sub-directory  (ie:  C:\TEMP).   Once  the  new file is
  159.        created  you  can  then  delete all the files and  remove  the  sub-
  160.        directory  (refer  to your DOS manual for creating and removing sub-
  161.        directories).
  162.  
  163.        Compare File Lists
  164.  
  165.        This is where the actual  comparisons  take  place.  After selecting
  166.        this option you are prompted for the name of the  files  to compare.
  167.        If  the  files are located in the current working directory, all you
  168.        need to type in is the filenames, otherwise, input the complete path
  169.        and filenames.
  170.  
  171.                EXAMPLE: C:\TEMP\MY_FILE.LST  or  B:FILELIST.TXT
  172.  
  173.        Next, you will be prompted for the path to store  the  output files.
  174.        Just put the complete path without any filenames or just leave blank
  175.        for the current directory.   COMPARE  will  then  begin  to  extract
  176.        filenames  from both lists and store them in two separate  temporary
  177.        files.  It  will  match  file  1 against file 2 and create an output
  178.        file containing the filenames that are not listed in file 1 (are you
  179.        with me?).  Next, it will repeat the process, creating  another file
  180.        containing  the  names of files not listed in file 2.  The new files
  181.        will have the same filenames but the extension "OUT" is added.
  182.  
  183.        Once completed, the previously  entered  filenames  will  become the
  184.        default  filenames  in case you wish to compare them  again  against
  185.        other  filelists.  You can then look at each list to see which files
  186.        a BBS already has or that you don't have.
  187.  
  188.        Sort Files
  189.  
  190.        Select this option to sort the output file(s) in alphabetical order.
  191.        COMPARE will search the current path for text files  with  an  "OUT"
  192.        extension  and read these files.  Once sorting is complete, You will
  193.        be                                                         notified.
  194.        ___________________________________________________________________
  195.        COMPARE Version 2.14                                          Page 2
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.        Quit
  206.  
  207.        Select this option to quit the program and return to DOS.
  208.  
  209.  
  210.        ACKNOWLEDGMENTS
  211.  
  212.        I would  like to thank Craig LaCoss for giving me this "Assignment".
  213.        While developing this program  Craig, along with Jim Smoot were very
  214.        helpful in the debugging and suggestion departments (hopefully,
  215.        they didn't miss anything).  Thanks for keeping me  "chk"  guys!  By
  216.        the  way,  Craig is the SysOp of MEGABYTE BBS (408) 883-0604 and Jim
  217.        is SysOp for the VIKING BBS  (408)  883-2853.  Both BBSs are located
  218.        on the Monterey Peninsula, CA.  Give 'em a call sometime.
  219.  
  220.  
  221.        SHAREWARE AGREEMENT
  222.  
  223.        COMPARE, version 2.14 is distributed has shareware,  therefore,  you
  224.        may  make copies of the program and its documentation and distribute
  225.        them freely to others under the following conditions:
  226.  
  227.        1.  No fee or other consideration  is  to  be charged for copying or
  228.        distributing the program without written permission from the
  229.        author.
  230.  
  231.        2.  The program and its documentation are not to be modified  in any
  232.        form.
  233.  
  234.        3.  Commercial users are required to register their copies.
  235.  
  236.  
  237.        REGISTRATION
  238.  
  239.        If  you  like this program and find it useful, a registration fee of
  240.        $15.00 is requested.  For  your  convenience, a registration form is
  241.        included. (See REGISTER.DOC)
  242.  
  243.        Registration entitles you to the following:
  244.  
  245.        1.  A serialized diskette with the latest version available  at time
  246.        of registration.
  247.  
  248.        2.  Registered  users  can request modified versions of this program
  249.        to  search  for any additional  file  extensions  they  desire.  The
  250.        Shareware version searches for ZIP, ARC, EXE, TXT,  LZH,  GIF,  DOC,
  251.        FLI, GL, COM, LST and MAC extensions.
  252.  
  253.        3.  You  will  receive continued telephone support for questions you
  254.        may have.
  255.  
  256.        4.  Notifications of future upgrades to this program.
  257.  
  258.        5.  Notification of new products developed.
  259.  
  260.        __________________________________________________________________
  261.        COMPARE Version 2.01                                         Page  3
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.        FUTURE ENHANCEMENTS
  272.  
  273.        1.  The  ability  to  search  file lists for specific  filenames  or
  274.        extensions.
  275.  
  276.        2.  A built-in text editor to view and edit file lists.
  277.  
  278.  
  279.        DISCLAIMER
  280.  
  281.        COMPARE  is  provide  "as  is"  without warranty of any kind, either
  282.        expressed or implied, including  but  not  limited  to  the  loss of
  283.        business profits or information, business interruption  or any other
  284.        loss  arising  out  of  the  use  or  inability to use this software
  285.        product.
  286.  
  287.  
  288.        Questions  or  comments will  be  deeply  appreciated.   If  there's
  289.        something about this program that you like or dislike,  please  tell
  290.        me.  It  makes  me  try  that much harder.  You may contact me on my
  291.        bulletin board:   Ed's BBS  (408)384-3658  or you can leave messages
  292.        in the Shareware conference on the RIME network.
  293.  
  294.  
  295.  
  296.                                 Edward Gause
  297.                                 1037 Scott Ct
  298.                                 Ft Ord, CA 93941
  299.                                 (Voice) (408)883-0084
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.        __________________________________________________________________
  327.        COMPARE Version 2.14                                        Page 4
  328.  
  329.  
  330.  
  331.